home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 2002 November / CD 1 / APC0211D1.ISO / workshop / prog / files / ActivePerl-5.6.1.633-MSWin32.msi / _e36c696ee3284af6b8f759ab9d3346df < prev    next >
Encoding:
Text File  |  2001-09-04  |  7.3 KB  |  219 lines
  1. If you read this file _as_is_, just ignore the funny characters you
  2. see. It is written in the POD format (see pod/perlpod.pod) which is
  3. specially designed to be readable as is.
  4.  
  5. =head1 NAME
  6.  
  7. README.vos - Perl for Stratus VOS
  8.  
  9. =head1 SYNOPSIS
  10.  
  11. This is a port of Perl version 5 to VOS.  Perl is a scripting or
  12. macro language that is popular on many systems.  See your local
  13. computer bookstore for a number of good books on Perl.
  14.  
  15. =head2 Stratus POSIX Support
  16.  
  17. Note that there are two different implementations of POSIX.1
  18. support on VOS.  There is an alpha version of POSIX that is
  19. available from the Stratus anonymous ftp site
  20. (ftp://ftp.stratus.com/pub/vos/posix/alpha/alpha.html).  There
  21. is a generally-available version of POSIX that comes with the
  22. VOS Standard C compiler and C runtime in VOS Release 14.3.0 or
  23. higher.  This port of POSIX will compile and bind with either
  24. version of POSIX.
  25.  
  26. Most of the Perl features should work on VOS regardless of which
  27. version of POSIX that you are using.  However, the alpha version
  28. of POSIX is missing a number of key functions, and therefore any
  29. attempt by perl.pm to call the following unimplemented POSIX
  30. functions will result in an error message and an immediate and
  31. fatal call to the VOS debugger.  They are "dup", "fork", and
  32. "waitpid".  The lack of these functions pretty much prevents you
  33. from starting VOS commands and grabbing their output in perl.
  34. The workaround is to run the commands outside of perl, then have
  35. perl process the output file.  These functions are all available
  36. in the generally-available version of POSIX.
  37.  
  38. =head1 INSTALLING PERL IN VOS
  39.  
  40. =head2 Compiling Perl 5 on VOS
  41.  
  42. Before you can build Perl 5 on VOS, you need to have or acquire the
  43. following additional items.
  44.  
  45. =over 5
  46.  
  47. =item 1
  48.  
  49. The VOS Standard C Compiler and Runtime, or the VOS Standard C
  50. Cross-Compiler.  This is a standard Stratus product.
  51.  
  52. =item 2
  53.  
  54. Either the VOS OS TCP/IP or STCP product set.  If you are
  55. building with the alpha version of POSIX you need the OS
  56. TCP/IP product set.  If you are building with the
  57. generally-available version of POSIX you need the STCP
  58. product set.  These are standard Stratus products.
  59.  
  60. =item 3
  61.  
  62. Either the alpha or generally-available version of the VOS
  63. POSIX.1 environment.
  64.  
  65. The alpha version of POSIX.1 support is available on the
  66. Stratus FTP site.  Login anonymously to ftp.stratus.com and
  67. get the file /pub/vos/posix/alpha/posix.save.evf.gz in
  68. binary file-transfer mode.  Or use the Uniform Resource
  69. Locator (URL)
  70. ftp://ftp.stratus.com/pub/vos/alpha/posix.save.evf.gz from
  71. your web browser.  Instructions for unbundling this file
  72. are at ftp://ftp.stratus.com/pub/vos/utility/utility.html.
  73. This is not a standard Stratus product.
  74.  
  75. The generally-available version of POSIX.1 support is
  76. bundled with the VOS Standard C compiler and Runtime (or
  77. Cross-Compiler) in VOS Release 14.3.0 or higher.  This is a
  78. standard Stratus product.
  79.  
  80. =item 4
  81.  
  82. You must compile this version of Perl 5 on VOS Release
  83. 14.1.0 or higher because some of the perl source files
  84. contain more than 32,767 source lines.  Due to VOS
  85. release-compatibility rules, this port of perl may not
  86. execute on VOS Release 12 or earlier.
  87.  
  88. =back
  89.  
  90. To build perl 5, change to the "vos" subdirectory and type the
  91. command "compile_perl -processor X", where X is the processor
  92. type (mc68020, i80860, pa7100, pa8000) that you wish to use.
  93. Note that the generally-available version of POSIX.1 support is
  94. not available for the mc68020 or i80860 processors.
  95.  
  96. You must have purchased the VOS Standard C Cross Compiler in
  97. order to compile perl for a processor type that is different
  98. from the processor type of the module.
  99.  
  100. Note that code compiled for the pa7100 processor type can
  101. execute on the PA7100, PA8000, PA8500 and PA8600 processors, and
  102. that code compiled for the pa8000 processor type can execute on
  103. the PA8000, PA8500 and PA8600 processors.
  104.  
  105. =head2 Installing Perl 5 on VOS
  106.  
  107. =over 4
  108.  
  109. =item 1
  110.  
  111. Create the directory >system>ported>command_library.
  112.  
  113. =item 2
  114.  
  115. Copy the appropriate version of the perl program module to
  116. this directory.  For example, with your current directory
  117. set to the top-level directory of Perl 5, to install the
  118. executable program module for the Motorola 68K
  119. architecture, enter:
  120.  
  121.           !copy_file vos>obj>perl.pm >system>ported>command_library>*
  122.  
  123. (If you wish to use both Perl version 4 and Perl version 5,
  124. you must give them different names; for example, perl.pm
  125. and perl5.pm).
  126.  
  127. =item 3
  128.  
  129. Create the directory >system>ported>perl>lib.
  130.  
  131. =item 4
  132.  
  133. Copy all of the files and subdirectories from the lib
  134. subdirectory into this new directory.  For example, with
  135. the current directory set to the top-level directory of the
  136. perl distribution, enter:
  137.  
  138.           !copy_dir lib >system>ported>perl>lib>5.6
  139.  
  140. =item 5
  141.  
  142. While there are currently no architecture-specific
  143. extensions or modules distributed with perl, the following
  144. directories can be used to hold such files:
  145.  
  146.           >system>ported>perl>lib>5.6.68k
  147.           >system>ported>perl>lib>5.6.860
  148.           >system>ported>perl>lib>5.6.7100
  149.           >system>ported>perl>lib>5.6.8000
  150.  
  151. =item 6
  152.  
  153. Site-specific perl extensions and modules can be installed in one of
  154. two places.  Put architecture-independent files into:
  155.  
  156.           >system>ported>perl>lib>site>5.6
  157.  
  158. Put architecture-dependent files into one of the following
  159. directories:
  160.  
  161.           >system>ported>perl>lib>site>5.6.68k
  162.           >system>ported>perl>lib>site>5.6.860
  163.           >system>ported>perl>lib>site>5.6.7100
  164.           >system>ported>perl>lib>site>5.6.8000
  165.  
  166. =item 7
  167.  
  168. You can examine the @INC variable from within a perl program
  169. to see the order in which Perl searches these directories.
  170.  
  171. =back
  172.  
  173. =head1 USING PERL IN VOS
  174.  
  175. =head2 Unimplemented Features
  176.  
  177. If perl is built with the alpha version of VOS POSIX.1 support
  178. and if it attempts to call an unimplemented VOS POSIX.1
  179. function, it will print a fatal error message and enter the VOS
  180. debugger.  This error is not recoverable.  See vos_dummies.c for
  181. a list of the unimplemented POSIX.1 functions.  To see what
  182. functions are unimplemented and what the error message looks
  183. like, compile and execute "test_vos_dummies.c".
  184.  
  185. =head2 Restrictions
  186.  
  187. This port of Perl version 5 to VOS prefers Unix-style,
  188. slash-separated pathnames over VOS-style greater-than-separated
  189. pathnames.  VOS-style pathnames should work in most contexts, but
  190. if you have trouble, replace all greater-than characters by slash
  191. characters.  Because the slash character is used as a pathname
  192. delimiter, Perl cannot process VOS pathnames containing a slash
  193. character in a directory or file name; these must be renamed.
  194.  
  195. This port of Perl also uses Unix-epoch date values internally.
  196. As long as you are dealing with ASCII character string
  197. representations of dates, this should not be an issue.  The
  198. supported epoch is January 1, 1980 to January 17, 2038.
  199.  
  200. See the file pod/perlport.pod for more information about the VOS
  201. port of Perl.
  202.  
  203. =head1 SUPPORT STATUS
  204.  
  205. I'm offering this port "as is".  You can ask me questions, but I
  206. can't guarantee I'll be able to answer them.  There are some
  207. excellent books available on the Perl language; consult a book
  208. seller.
  209.  
  210. =head1 AUTHOR
  211.  
  212. Paul Green (Paul_Green@stratus.com)
  213.  
  214. =head1 LAST UPDATE
  215.  
  216. February 13, 2001
  217.  
  218. =cut
  219.